home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #156 (1992-02)(Rhein-Sieg-Soft).zip / Franz PD Disk #156 (1992-02)(Rhein-Sieg-Soft).adf / PR / PR.doc < prev    next >
Text File  |  1992-01-30  |  19KB  |  440 lines
  1. ==============================================================================
  2. ==============================================================================
  3. ===                  Romanverwaltung 'PR' V2.08a rel. 2812-91              ===
  4. ===                                                                        ===
  5. ===                      (LAUFFAEHIG AUCH UNTER OS V2.04)                  ===
  6. ===                                                                        ===
  7. ==============================================================================
  8. ===                       ( S H A R E W A R E )                            ===
  9. ==============================================================================
  10. ===              (benoetigt V34.01 oder hoeher der "ak_gen0.library")      ===
  11. ==============================================================================
  12. ===                                                                        ===
  13. ===                       (c) 1989-91 by Andreas Ralph Kleinert            ===
  14. ===                                      Grube Hohe Grethe 23              ===
  15. ===                                      W-5900 Siegen 1                   ===
  16. ===                                      Germany                           ===
  17. ===                                                                        ===
  18. ==============================================================================
  19. ==============================================================================
  20.  
  21.      "Romanverwaltung 'PR'" ist (C)opyright 1990-91 by Andreas R. Kleinert
  22.      und darf frei kopiert werden. Eine "Entrichtung" des SHARE-Betrages ist
  23.      erwuenscht, aber nicht Zwang. Eine eventuell verlangte Kopiergebuehr pro
  24.      Diskette sollte 10 DM bzw. das 5-fache des Leerdiskettenpreises nicht
  25.      uebersteigen.
  26.      ERWUENSCHT ist allerdings ein Betrag, der, bis auf eine geringe Kopier-
  27.      gebuehr, in etwa dem Preis einer Leerdiskette entspricht.
  28.      "Romanverwaltung 'PR'" darf nicht unvollstaendig weitergegeben werden !
  29.      Bestandteile von "Romanverwaltung 'PR'" V2.08a sind :
  30.  
  31.       - diese Anleitung
  32.       - "Romanverwaltung 'PR'" V2.08a selbst
  33.       - PRConvert V2.08a
  34.       - die "ak_gen0.library" und ihre Anleitung
  35.       - der restliche Inhalt dieses Directories, soweit als Bestandteil
  36.         von "Romanverwaltung 'PR'" gekennzeichnet
  37.  
  38.      ----- Dokumentationsfile-Version : V2.08a-A-2812-91 -----
  39.  
  40. =============================================================================
  41. = PROGRAMMBESCHREIBUNG :                                                    =
  42. =============================================================================
  43.  
  44.      "Romanverwaltung 'PR' V2.08a" ist ein Programm zum planmaessi-
  45.      gen Erfassen, Verwalten und Auswerten von groesseren Bestaen-
  46.      den an Zeitschriften, Buechern, oder insbesondere sogenannten Heft-
  47.      ("Groschen-")romanen.
  48.      (Dieses Programm ist besonders fuer Sammler geeignet.)
  49.  
  50.      Benoetigter Speicher :
  51.                             - ideal : 1 MB oder mehr
  52.                               (Am besten 1 MB ChipRAM !)
  53.      System-Konfiguration :
  54.                             - OS V1.2 - OS V2.04
  55.                               (Unter OS V1.2/V1.3 sollte, falls moeglich,
  56.                                "SetPatch V1.38" installiert werden, da dieser
  57.                                Befehl einige Fehler der Listenverwaltungs-
  58.                                funktionen in Exec behebt !)
  59.                             - benoetigt ak_gen0.library V34.01 oder hoeher
  60.      Kapazitaet           :
  61.                             - theoretisch nur durch die Kombinations-
  62.                               moeglichkeiten des Suchbegriffs (7 Zeichen)
  63.                                und den freien Speicher begrenzt
  64.                             -   7 Zeichen Suchbegriff +
  65.                                99 Zeichen Titel       +
  66.                               199 Zeichen Untertitel  +
  67.                                29 Zeichen Autorenname +
  68.                                29 Zeichen ISBN-Nr.
  69.      Features             :
  70.                             - komfortable Eingabemoeglichkeit
  71.                             - Loeschfunktion
  72.                             - Suchfunktion fuer Titel
  73.                             - Suchfunktion fuer Autoren
  74.                             - Listenausgabe (Drucker)
  75.                             - etc.
  76.  
  77.      Besonderheit(en)     :
  78.                             - dynamische Speicherverwaltung nach dem Listen-
  79.                               system (Verwendung von "Nodes")
  80.  
  81. =============================================================================
  82. = HINWEIS :                                                                 =
  83. =============================================================================
  84.  
  85.      DIESES PROGRAMM IST SHAREWARE !!!
  86.    
  87.    - Was bedeutet dies konkret ?
  88.  
  89.      Wenn Sie dieses Programm regelmaessig benutzen, entrichten Sie bitte
  90.      einen SHARE-Betrag von DM 15 an mich. Dies ist jedoch FREIWILLIG
  91.      (deshalb ist dieses Programm keine KOMMERZIELLE Shareware) !!!
  92.      Haben Sie den SHARE-Betrag an mich entrichtet, so koennen Sie von
  93.      mir gegen Leerdiskette und Rueckporto (RP) jeweils die neueste Version
  94.      dieses Programmes in regelmaessigen Abstaenden (also ca. >= 2-3 Mon.)
  95.      erhalten.
  96.  
  97.      Dieses Angebot gilt solange, bis ich mich, aus welchen Gruenden auch im-
  98.      mer, nicht mehr in der Lage sehe, es zu diesen vergleichsweise gross-
  99.      zuegigen Bedingungen zu erfuellen (s.u.).
  100.  
  101.  
  102.    - Was geschieht, wenn dieses Angebot einmal NICHT mehr gelten
  103.      sollte (s.o.) ?
  104.  
  105.      Alternativen :
  106.  
  107.      a) Es faende keine Weiterentwicklung mehr statt.
  108.         (Unwahrscheinlich aber moeglich.)
  109.  
  110.       oder :
  111.  
  112.      b) Dieses Programm koennte in einer spaeteren Version als kommerzielle
  113.         Shareware vertrieben werden, eventuell mit Rabatt fuer diejenigen,
  114.         die bereits den freiwilligen Sharebetrag bezahlt haben.
  115.  
  116.       oder :
  117.  
  118.      c) Dieses Programm koennte in einer spaeteren Version komplett kommer-
  119.         ziell vertrieben werden.
  120.  
  121.      Fazit :
  122.  
  123.      Wuerde mir jemand, nachdem dieses Angebot bereits NICHT mehr gilt, noch
  124.      15 DM + RP + Leerdiskette zusenden, so wuerde ich den dazu notwendigen
  125.      Teil des RP dazu verwenden, um die 15 DM sowie die Diskette (leer) und
  126.      den Rest des RP zurueckzusenden, und ausserdem eine Information beilegen,
  127.      die Auskunft darueber gibt, welchen Status (a,b,c,?) die neue Version
  128.      des Programmes nun besizt und warum.
  129.      Selbstverstaendlich erhielten dann auch alle diejenigen, die bereits den
  130.      SHARE-Betrag bezahlt haben und mir eine Diskette mit RP schickten, um
  131.      ein Update zu bekommen, die Diskette und den Rest des RP zurueck, aller-
  132.      dings eventuell noch zusaetzlich mit einem Vorzugsangebot fuer die neue
  133.      Version (s.o.).
  134.  
  135.      Dies ist jedoch momentan alles (noch) nicht in greifbarer Naehe. Auch
  136.      glaube ich nicht, dass dieses Programm bereits ausgereift genug waere,
  137.      um auf dem kommerziellen (Shareware-)Markt Bestand haben zu koennen.
  138.  
  139.      Es lohnt sich also, einmal darueber nachzudenken, die (freiwillige)
  140.      SHAREWARE-Idee zu foerdern, zumal niemand ein Risiko eingeht (schon gar
  141.      nicht bei 15 DM) !
  142.  
  143.    - Notwendige Infomationen fuer mich :
  144.  
  145.      Geben Sie bitte immer auf jeden Fall die Version dieses Programmes an,
  146.      die Sie besitzen, so dass ich sehe, ob ein "Update" schon (oder noch)
  147.      moeglich bzw. sinnvoll ist.
  148.      Vergessen Sie bitte auch nicht, fuer alle Faelle Ihre Telefonnummer an-
  149.      zugeben !!!
  150.  
  151. =============================================================================
  152. = INSTALLATION :                                                            =
  153. =============================================================================
  154.  
  155.     Kopieren Sie die beigefuegte (oder eine hoehere) Version der
  156.     "ak_gen0.library" in das "LIBS:"-Verzeichnis (normalerweise "SYS:libs").
  157.  
  158. =============================================================================
  159. = START :                                                                   =
  160. =============================================================================
  161.  
  162.     1) Sorgen Sie fuer genuegend freien Speicher (besonders CHIP-Mem).
  163.     2) Ueberpruefen Sie die Stack-Groesse (naeheres s.u.).
  164.     3) Gehen Sie sicher, dass die "ak_gen0.library" V34.01 oder hoeher sich
  165.        im Verzeichnis "LIBS:" befindet.
  166.     4) Starten Sie "Romanverwaltung 'PR'" durch :
  167.  
  168.         a) Anklicken des Icons auf der Workbench.
  169.  
  170.         b) Eingabe von
  171.                          b-a)     Run PR
  172.  
  173.                            oder
  174.  
  175.                          b-b)     PR 
  176.  
  177.            im CLI / in der Shell.
  178.  
  179.     Falls Probleme auftauchen sollten, lesen Sie bitte die untenstehenden,
  180.     diesbezueglichen Hinweise (moeglichst schon vorher !).
  181.  
  182. =============================================================================
  183. = BEDIENUNG :                                                               =
  184. =============================================================================
  185.  
  186.    (Weitestgehend selbsterklaerend. Eine genauere Anleitung ist von mir
  187.     wie oben bereits erwaehnt erhaeltlich !)
  188.  
  189.  
  190.    - Aussehen einer PRCard, Bedeutung der Eintraege :
  191.  
  192.      Nummer     :
  193.                   Suchbegriff (am besten Zahl). Keine Positionsangabe !
  194.                   [ Zahl / String    ]
  195.                   [ max. 7 Zeichen   ]
  196.      Titel      :
  197.                   Titel des Romans
  198.                   [ Text             ]
  199.                   [ max. 99 Zeichen  ]
  200.      Untertitel :
  201.                   Zweiter Titel und/oder andere Informationen
  202.                   [ Text             ]
  203.                   [ max. 199 Zeichen ]
  204.      Autor      :
  205.                   Autorenname / Pseudonym
  206.                   [ Text             ]
  207.                   [ max. 29  Zeichen ]
  208.      ISBN-Nr.   :
  209.                   ISBN-Nr. oder andere Informationen
  210.                   [ Text             ]
  211.                   [ max. 29 Zeichen  ]
  212.  
  213.    - Verwendung der Suchfunktion :
  214.  
  215.      Die Funktion "Suchen" beruecksichtigt Gross-/Kleinschrift !
  216.  
  217.    - Verwendung von "PRConvert V2.08a" (fuer Benutzer aelterer Versionen) :
  218.  
  219.      Fuer alle Benutzer frueherer Versionen ist dieses Hilfsprogramm ge-
  220.      eignet. Es konvertiert alte Datensaetze (von Versionen vor V2.06a)
  221.      in die neue, fuer diese Version geeignete Form.
  222.      Diese neue Form benoetigt allerdings mehr Platz als die aeltere.
  223.      Bitte beachten Sie dies, damit Sie nicht unerwartet Platzprobleme
  224.      bekommen !
  225.  
  226. =============================================================================
  227. = WICHTIGE HINWEISE :                                                       =
  228. =============================================================================
  229.  
  230.    (1)
  231.  
  232.    Wenn Sie "Romanverwaltung 'PR'" nicht mit dem Original-ICON von der Work-
  233.    bench aus starten, achten Sie bitte darauf, dass der voreingestellte Stack-
  234.    speicher mindestens 25000 Bytes umfasst (meistens reicht auch weniger, aber
  235.    sicher ist sicher(er) !). Im Zweifelsfall bitte auch die Eintragung im
  236.    ICON ueberpruefen (s.u.) !
  237.  
  238.    Die Einstellung der Stackgroesse kann erfolgen :
  239.  
  240.     1) bei Workbench-Start : im "Info"-Menue der Workbench.
  241.  
  242.      oder
  243.  
  244.     2) bei CLI-/Shell-Start : mit dem "Stack"-Befehl
  245.  
  246.        (z.B. "1> Stack 25000")
  247.  
  248.    ACHTUNG :
  249.  
  250.    DIES WAR EINE DER HAEUFIGSTEN ABSTURZURSACHEN FRUEHERER VERSIONEN !
  251.    (DIESE STUERZTEN AB, OBWOHL SIE EIGENTLICH FEHLERFREI WAREN, DA DER
  252.     STACK ZU KNAPP BEMESSEN WAR !!!!!!!)
  253.  
  254.    (2)
  255.  
  256.    Sorgen Sie dafuer, dass beim Einlesen von Dateien genuegend Speicher fuer
  257.    die Daten vorhanden ist !
  258.    Ein Eintrag benoetigt : 100 (Titel) + 200 (Untertitel) + 30 (Autor) + 30
  259.    (ISBN-Nr.) + 22 (Verwaltung) = 382 Bytes.
  260.  
  261.    Das ergibt fuer eine Datei mit 200 Eintraegen einen Speicherplatzbedarf
  262.    von :
  263.  
  264.     (200)*(382) = 76400 Bytes.
  265.  
  266.    Die Aufteilung groesserer Verwaltungseinheiten in kleinere Untergruppen
  267.    bietet sich an (z.B. : Romane_1.dat, Romane_2.dat, Romane_x.dat).
  268.  
  269.    "Romanverwaltung 'PR'" ueberprueft zwar selbststaendig, ob genug Speicher
  270.    vorhanden ist, aber sicher ist sicher !
  271.  
  272. =============================================================================
  273. = VERSIONS-"HISTORY" :                                                      =
  274. =============================================================================
  275.  
  276.    V1.0  :
  277.  
  278.     - Erste Version.
  279.  
  280. ------------------------------------------------------------------------------
  281.  
  282.    V1.11 :
  283.  
  284.     - Implementation einer Druckerroutine
  285.     - Verbesserung der CLS-Routine
  286.     - Fehlerkorrektur an den Load- und Saveroutinen
  287.     - Ermoeglichen der Verwendung von Leerzeichen (vorher : "_")
  288.     - Optimierung der Programmstruktur
  289.  
  290. ------------------------------------------------------------------------------
  291.  
  292.    V1.12 :
  293.  
  294.     - Verkleinerung des Programmcodes um mehr als 3000 Bytes bei gleicher
  295.       Leistung (durch Optimierung der Programmstruktur)
  296.     - kleinere Veraenderungen 
  297.  
  298. ------------------------------------------------------------------------------
  299.  
  300.    V1.13 :
  301.  
  302.     - Verkleinerung des Programmcodes durch Nutzung der "ak.library"
  303.     - kleinere Fehlerkorrekturen
  304.     - Codeoptimierungen 
  305.  
  306. ------------------------------------------------------------------------------
  307.  
  308.    V1.14 :
  309.  
  310.     - Veraenderungen am Programmaufbau
  311.     - kleinere Fehlerkorrekturen
  312.     - Codeoptimierungen
  313.  
  314. ------------------------------------------------------------------------------
  315.  
  316.    V2.00a :
  317.  
  318.     - erhebliche Veraenderungen am Aufbau des Programmes
  319.     - Ueberarbeitung der wesentlichsten Programmteile
  320.     - optische Verbesserungen
  321.     - vermehrte Integrierung von Requester-Abfragen an wichtigen Stellen
  322.     - erhebliche Verbesserung des File-Requesters
  323.  
  324. ------------------------------------------------------------------------------
  325.  
  326.    V2.03 :
  327.  
  328.     - Korrektur eines schwerwiegenden Fehlers am Filerequester (wurde von
  329.       mir leider erst nach der Testphase bemerkt)
  330.     - erhebliche Veraenderungen am Aufbau des Programmes
  331.     - Einbau verschiedener neuer Sicherheitsabfragen
  332.     - neue Hilfen (Gadgets) bei der Ein-/Ausgabe
  333.     - Veraenderung des Abspeicher- und Ladeverhaltens auf Diskette
  334.     - variable Speicherverwaltung !!!
  335.     - Nutzung der Version V34.00 der "ak.library"
  336.  
  337. ------------------------------------------------------------------------------
  338.  
  339.    V2.04 :
  340.  
  341.     - Sehr starke Verkuerzung des Programmcodes
  342.     - Korrektur des Abspeicher- und Ladeverhaltens auf Diskette
  343.       (zus. Sicherheitsabfrage, anderes Einleseverhalten)
  344.     - Nutzung der Version V34.10 der "ak.library"
  345.  
  346. ------------------------------------------------------------------------------
  347.  
  348.    V2.06a :
  349.  
  350.     - komplette Ueberarbeitung des Programmes
  351.     - vollkommen dynamische Speicherverwaltung (Verwendung von Listen, Nodes)
  352.     - komfortablere Handhabung
  353.     - weitere Informationen verwaltbar (Autor, ISBN-Nummer)
  354.     - erweiterte Suchfunktion
  355.     - Leerzeichenkonvertierung komplett ueberfluessig, da anderes Abspeicher-
  356.       verfahren
  357.     - Integrierung einer Loeschfunktion
  358.     - verschiedene andere Veraenderungen
  359.  
  360. ------------------------------------------------------------------------------
  361.  
  362.    V2.06b :
  363.  
  364.     - Umstellung auf 'ak_gen0.library' V34.01
  365.  
  366. ------------------------------------------------------------------------------
  367.  
  368.    V2.07a :
  369.  
  370.     - Verwendung der Farben von OS 2.04
  371.     - alle Gadgets jetzt im OS 2.04-Look
  372.     - kleinere Veraenderungen im Source
  373.     - Korrektur in der Fehlerbehandlung
  374.     - Fehler im "Suchen"-Menue beseitigt
  375.  
  376. ------------------------------------------------------------------------------
  377.  
  378.    V2.08a :
  379.  
  380.     - Fehler aus V2.07a (Ansichtsfunktionen) beseitigt
  381.     - Fehler aus V2.07a (Gadget der Suchfunktionen) beseitigt
  382.     - jetzt eigene Ueberpruefung auf freien Speicher in Laderoutine
  383.     - zwei neue Menuepunkte zur Suche von 'PRCards'
  384.     - Fehler bei der Textanzeige in String-Gadgets beseitigt (nur unter
  385.       OS V2.04 ???)
  386.     - Fehler bei der Beantwortung der lezten Messages vor Schliessen des Fens-
  387.       ters beseitigt
  388.     - kleinere Veraenderungen im Source
  389.     - Guru AN_BadMessage (0x8400000D) tritt nicht mehr bei Verlassen der
  390.       Ansichts- oder Eingabe-Menues auf (sporadisch, moeglicherweise nur
  391.       unter OS V2.04 ???)
  392.     - Fehler der "Untertitel"-Gadgets beseitigt (maximal 30 bzw. 29 Zeichen
  393.       statt 200 bzw. 199 !).
  394.  
  395. ------------------------------------------------------------------------------
  396. ------------------------------------------------------------------------------
  397.  
  398.    Bekannte Fehler :
  399.  
  400.     - Speicherfreigabe noch nicht 100%-ig (wird beseitigt)
  401.  
  402.     (fuer bekannte Fehler der 'ak_gen0.library', siehe deren Dokumentation)
  403.  
  404. ------------------------------------------------------------------------------
  405. ------------------------------------------------------------------------------
  406.  
  407.    Moegliche weitere Verbesserungen in spaeteren Versionen :
  408.  
  409.    - weitere interne Umkonfigurierung(en)
  410.    - weitere Erweiterung(en) des Funktionsumfanges
  411.    - weitere Optimierung(en) der Programmstruktur
  412.    - Fehlerverbesserung(en)
  413.  
  414.      Ich bitte ausdruecklich um die Zusendung von "BUG-Reports" !
  415.  
  416. =============================================================================
  417. = INFORMATIONEN ZUR 'ak_gen0.library' :                                          =
  418. =============================================================================
  419.  
  420.     Die mit diesem Programm zu verwendende "ak_gen0.library" besitzt eine ei-
  421.     gene Dokumentation. Bitte aufmerksam durchlesen !
  422.     Danke !
  423.  
  424. =============================================================================
  425. = COPYRIGHTS :                                                              =
  426. =============================================================================
  427.  
  428. =============================================================================
  429. =   "Romanverwaltung 'PR'"                                                  =
  430. =   (c) 1989-91 by Andreas R. Kleinert.                                     =
  431. =   SHAREWARE. All rights reserved.                                         =
  432. =============================================================================
  433. =   "ak_gen0.library"                                                       =
  434. =   (c) 1989-91 by Andreas R. Kleinert.                                     =
  435. =   FREEWARE. All rights reserved.                                          =
  436. =============================================================================
  437. =   Copyrights zu anderen erwaehnten Produkten/Programmen sind den jeweili- =
  438. =   gen Produktbeschreibungen der Hersteller/Vertreiber zu entnehmen.       =
  439. =============================================================================
  440.